오늘의 약속

오늘 약속 세 가지.

• 자기 폴더에 산출물 한 개를 들고 돌아가도록 끌고 갑니다.
• 모든 명령은 Windows PowerShell 기준. 한글 경로는 피하고 ASCII로.
• 모르는 게 떠오르면 바로 손을 들어 주세요.

· Claude Code Workshop

강사 한 줄 소개

한 줄 정의

내 폴더 안에서 직접 일하는 AI 동료.

Claude Code는 터미널·IDE에서 실행되는 AI 코드 에이전트. 채팅창에 코드를 복붙하는 방식이 아니라, AI가 본인 폴더 안에서 파일을 직접 읽고 편집합니다.

Claude 라인업

Web · Desktop · Code, 어떻게 다른가.

첫 시연 · 터미널 전환

회의록 3개 → 한 페이지 보고서.

Basic 트랙 — 도달 목표

슬라이드 한 장 = 기능 하나.

• 12개 기능을 그림과 짧은 명령으로 50분에 압축.
• 다 외울 필요 없음. 본인 일상에 와닿는 1~2개만 머리에 담아 가면 충분.
• 여기까지가 일상. Advanced (자동화 본편)는 휴식 뒤에 욕심 있는 분만 깊게.

개념

CLAUDE.md — 프로젝트 전용 지시문.

• 프로젝트 루트의 마크다운 한 파일. 매 세션 자동 로드.
• 4계층 cascade. managed (기관) → user (개인) → project (폴더) → local (개인 비공유).
• @import로 다른 마크다운을 끼워 넣을 수 있어요 — 랩 공용 규칙도 한 줄로.

사용법

CLAUDE.md 처음 만들기 — 두 줄이면 끝.

PS C:\work\my-project> claude
> /init
> notepad CLAUDE.md

# 본인 프로젝트
- 한국어로 답변
- 원본 데이터는 수정 금지, _clean 접미사로 새 파일
- 표는 마크다운 표로 출력
- 본인 랩의 표기 규칙 따르기

연구 시나리오

역할별로 어떻게 적을까.

실습 · 5분

실습 — 내 폴더에 CLAUDE.md 5줄.

개념

Auto Memory — 한 번 알려주면 계속 기억.

사용법

대화하면서 그때그때 정정.

> /memory                 # 토글
> /memory off             # 일시 비활성
PS> $env:CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
       # 영구 비활성

# Project Memory
- 표 출력은 마크다운 표 (랩 규칙)
- 원본 데이터 파일 수정 금지
- 답변은 한국어

시나리오 · 함정

효과는 크지만 주의할 점.

개념

사용법

Plan 모드 켜기 — Shift+Tab 두 번.

PS> claude --permission-mode plan
> /plan
> # Shift+Tab 두 번

연구 시나리오

언제 Plan 모드를 켜는가.

• Reviewer 2 응답 — 본문에 손대기 전 구조부터 받기
• R 코드 디버깅 — 처음 쓰는 분이라면 어디를 고칠지부터 보고
• 대용량 폴더 정리 — 200개 파일 이름 일괄 변경 전
• 한글 인코딩 변환 — 깨질 가능성 있는 작업 전

함정 · 팁

Plan 모드, 흔한 오해.

개념

권한은 6단계지만, 평소엔 두 개면 충분.

사용법

settings.json 한 파일에 — deny · ask · allow.

{
  "defaultMode": "acceptEdits",
  "permissions": {
    "deny": ["Bash(Remove-Item *)"],
    "ask":  ["Bash(git push *)"],
    "allow": ["Bash(Rscript *)"]
  }
}

자리별 진입점

내 자리엔 어떤 권한 모드?

실습 · 5분

실습 — deny 한 줄로 안전망.

개념

Skills — 한 번 만들면 매일 한 줄로.

사용법

SKILL.md, 자연어로 작성.

PS> mkdir ~/.claude/skills/pdf-summary
PS> notepad ~/.claude/skills/pdf-summary/SKILL.md
> /pdf-summary ./이문서.pdf

---
name: pdf-summary
description: PDF 한 편 → 요약·인용·시사점
allowed-tools: [Read, Grep]
paths: ["**/*.pdf"]
shell: powershell
---
# 절차
1. PDF 읽기
2. 한 문장 요약
...

시나리오

자리마다 어떤 스킬을 만들까.

실습 · 5분

실습 — 5줄짜리 SKILL.md.

개념

Subagents — 전문 분야 동료를 한 명 더.

• 별도 컨텍스트에서 작업하고 요약만 메인 세션에 돌려줌 (메모리 격리).
• .claude/agents/<name>.md YAML — name · description · tools · model · isolation.
• 통계 검토만 잘하는 동료 · 영문 첨삭만 잘하는 동료를 따로 둠.

사용법

서브에이전트 정의 — frontmatter + initialPrompt.

PS> mkdir .claude\agents
PS> notepad .claude\agents\deep-reviewer.md
> @deep-reviewer 이 문서를 검토해 줘

---
name: deep-reviewer
description: 까다로운 심사 위원 시각
tools: [Read, Grep, Glob]
model: opus
isolation: worktree
initialPrompt: ".md 초고 검토 시작"
---
# 검토 4관점
- 통계 가정
- 표본 크기 ...

연구 시나리오

동시에 검토하는 4명의 동료.

함정

서브에이전트, 흔한 실수 두 가지.

개념

사용법

/agents — Library와 Running 두 화면.

PS> claude
> /agents             # 두 탭 토글
# Tab 키로 Library ↔ Running

=== Library (5) ===
- statistics-reviewer
- citation-checker
- logic-reviewer
- english-editor
- code-reviewer        [running]

=== Running (1) ===
code-reviewer · 1m23s · 초고.md

시나리오

내 노트북에서 동시에 일하는 5명.

• 논문 리뷰 — reviewer 다섯 명 인스턴스를 동시에, 메인은 통합만.
• 코드 리뷰 — code-reviewer 두 인스턴스 (Python · R)로 분리.
• "내 컴퓨터가 다섯 명 몫 일을 하고 있다"는 실감.

개념

컨텍스트 관리 — /compact · /clear · /context.

사용법

/clear와 /compact, 한 글자 차이.

> /compact      # 압축 (이어가기)
> /clear        # 초기화 (다른 일)

요약 5문장
1. 본인 데이터에서 그룹 간 18% 차이
2. 핵심 변수의 안정 구간 식별
...
[컨텍스트 압축 · 토큰 78% → 22%]

시나리오 · 함정

언제 /compact를 쓰는가.

개념

/usage — 사용량과 비용을 한눈에.

시나리오

이번 주 비용, 어디에 썼나.

> /usage
> /extra-usage    # 세션·시간대별

1. PDF 5편 요약 · $2.10 · Read 비중 큼
2. 코드 디버깅 · $1.45 · 반복 실행
3. 회의록 합치기 · $0.85
권장. (1)에서 /pdf-summary 스킬로
      절차화 → 30% 절감

개념

사용법

세션 이어가기 · 이름 붙이기 · 분기하기.

PS> claude --continue
PS> claude --resume 2026-Q2-paper
PS> claude -n 2026-Q2-paper
PS> claude --fork-session 2026-Q2-paper
# Ctrl+A — 모든 프로젝트 세션

이어서 — 마지막 컨텍스트 복구
"논문 5편 표로 비교, 각 핵심 5문장씩"
계속 진행할까요? (Y/n)

일상 시나리오

하루 일과에 --resume 끼우기.

1. 오전. claude -n 분기-분석로 분석 시작.
2. 회의 · 점심으로 끊김 — Ctrl+C로 종료.
3. 점심 후. claude --resume 분기-분석로 같은 맥락에서 이어감.
4. 다른 결론을 시도. claude --fork-session으로 분기.

개념 · 실험 기능

팀장 한 명 + 팀원 여러 명, 자동으로.

사용법

실험 기능 켜고 팀 호출하기.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS":
      "1"
  }
}

lead → spawn statistics-reviewer
     → spawn citation-checker
     → spawn english-editor
공유 task list. [3/3 완료]
- 통계. 표본 크기 부족 ...
- 인용. 7개 누락 ...
- 영문. 도입부 hedging 과다 ...

시나리오 · 함정

Agent Teams, 켜기 전 체크리스트.

• 논문을 쓰시는 분 — reviewer 다섯 명 팀 (통계 · 인용 · 논리 · 영문 · 구조).
• 토큰 소비 큼. /usage로 실시간 모니터링.
• 실패 시 — lead만 답하고 teammate가 멈춰 있을 수 있음. /agents에서 확인.

개념

.claude/rules/ — 필요한 순간에만 자동으로.

• CLAUDE.md를 토픽별로 쪼개서 .claude/rules/<topic>.md로 분리.
• 각 룰에 paths: 글롭 — 해당 파일이 작업에 들어올 때만 자동 로드.
• 토큰 절약 + 정확도 — raw 데이터를 만질 때만 무결성 룰이 떠 줌.

사용법

paths 한 줄로 자동 로드 범위 지정.

PS> mkdir .claude\rules
PS> notepad .claude\rules\data-files.md

---
paths: ["data/원본/**"]
---
# 원본 데이터 무결성
- 원본 폴더의 파일은 절대 수정 금지
- 정제 결과는 _clean 접미사
- 헤더 변경 시 README 한 줄 기록

시나리오

여러 명이 같은 폴더를 쓸 때.

실습 · 5분

실습 — 룰 한 줄로 데이터 보호.

Basic 트랙 마무리

Basic 12개, 여기까지.

Advanced 트랙

Advanced — 자동화 10가지.

헤드리스 · 훅 · MCP · 플러그인 · Routines · 다중에이전트 · /loop · /schedule · /effort · UX 보조.

개념

사용법

claude -p — 셸 한 줄에 끼우기.

PS> Get-Content err.txt | claude -p
       "근본 원인 두 줄"
PS> claude -p "..."
       --max-budget-usd 1.00

Get-Content data\input.csv |
  claude -p "헤더 통일·결측 NA·CSV" `
  --max-budget-usd 1.00 |
  Set-Content data\clean.csv

연구 시나리오

야간 잡 · 일괄 변환에 어울림.

• 시뮬레이션 자리. 야간 LAMMPS 잡 끝나면 후처리 한 줄 — 아침에 정제 CSV.
• 행정 · 정책 자리. 매주 표 → 보고체 두 단락 변환을 한 줄로.
• --output-format json + 스키마 — 결과를 다음 단계 스크립트가 그대로 받음.
• CI 통합. GitHub Actions · GitLab CI에 한 줄로.

실습 · 함정

실습 — claude -p로 CSV 한 줄 변환.

개념

Hooks — 작업 흐름 곳곳에 핸들러.

사용법

settings.json에 Hook 한 블록.

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash(Remove-Item *)",
      "command": "powershell -c \"exit 2\""
    }]
  }
}

> rm -rf *
[hook 차단됨 · exit 2]
사용자 확인 필요.
진짜 진행할까요? (취소)

연구 시나리오

실제로 자주 쓰는 Hook 패턴.

• 시뮬레이션 자리. PostToolUse Edit → black 자동 포맷 + git commit.
• 행정 · 정책 자리. 응답이 끝나면 데스크톱 알림 (toast).
• 모두. 원본 데이터 수정 명령은 PreToolUse에서 차단 → 데이터 무결성.
• 학생 코드 자동 로깅. 모든 Edit를 jsonl 로그로 누적.

함정

Hooks, 치명적 함정 두 가지.

개념

MCP — 외부 시스템을 한 채팅 안으로.

사용법

MCP 서버, 한 줄로 등록.

PS> claude mcp add github `
  --transport http --scope project `
  --env GITHUB_TOKEN=$env:GH_TOKEN `
  -- https://api.github.com/mcp
PS> claude mcp list
> /mcp           # 상태

1. wiki MCP → 페이지 fetch
2. summarize · 5줄
3. slack MCP → 채널 post
완료. 메시지 ts: 1719...

연구 시나리오

자리마다 하나씩, MCP.

함정

MCP, 켜기 전 보안 체크.

개념

사용법

설치 · 검증 · 버전 태그.

PS> claude plugin install my-lab@private
PS> claude plugin list
PS> claude plugin validate
PS> claude plugin tag my-lab@2026.04
PS> claude plugin prune

{
  "name": "my-lab",
  "version": "2026.04",
  "skills":  ["pdf-summary","meeting-summary"],
  "agents":  ["statistics-reviewer"],
  "hooks":   [".claude/hooks/raw-protect.json"],
  "mcp":     [".mcp.json"]
}

연구 시나리오

랩 표준을 한 묶음으로 배포.

• 팀장 자리. 본인 환경 → 플러그인 → 팀원에게 한 줄 install.
• 온보딩. 신규 합류자 첫날 — claude plugin install my-lab 한 줄로 동일한 환경.
• 업데이트. tag 한 번이면 모든 팀원 환경이 동기화.
• 기관 마켓플레이스. private git repo로 운영 — 외부 노출 0.

함정

Plugins — 이름 충돌과 보안.

사용법

/schedule — 자연어 한 줄로 등록.

> /schedule weekdays 8am, 어제
       부처 보도자료 5개 요약 → 위키
> /schedule list
> /schedule update [id] [자연어]

등록됨. routine_id: rtn_4f8a...
다음 실행. 2026-05-04(월) 08:00 KST
연결. wiki MCP · scope cloud
환경변수. WIKI_TOKEN (검증 OK)

트리거 세 가지

실행을 깨우는 세 가지 방법.

시나리오

자리별로 자동화하는 일.

함정 · 선택 실습

Routines, 켜기 전 세 가지.

개념

/ultrareview · /ultraplan — 여러 관점 동시에.

• 클라우드에서 여러 서브에이전트가 병렬로 PR 리뷰 또는 큰 계획을 짭니다.
• 브라우저 검토 화면 — 여러 관점을 한 화면에서 비교.
• Reviewer 2 시뮬레이션. 의도적으로 관점 분산.

사용법

검토(review) vs 계획(plan).

> /ultrareview         # 현재 변경
> /ultrareview 142     # PR #142
> /ultraplan <지시>
       # 큰 계획 다관점 수립

3관점 병렬 진행 중...
[보안] 토큰 저장·갱신 ...
[테스트] 통합 테스트 셋 ...
[롤백] 이전 버전 복귀 절차 ...
통합 단계 표 ↓

시나리오

실제로 어떻게 쓰나.

• 논문 자리. 초고를 통계 · 인용 · 논리 · 영문 네 관점으로 자동 검토 — Reviewer 2 시뮬레이션.
• 코드 자리. PR 리뷰 자동 — 보안 · 성능 · 테스트 세 관점.
• 회수율. 본 게재 후 reviewer 코멘트 절반이 미리 잡힘 (제가 본 사례).

함정

클라우드 의존, 망분리는 주의.

개념

사용법

/loop — 세 가지 사용 모드.

> /loop 5m queue 상태 확인
> /loop queue 상태   # dynamic
> /loop maintenance  # 유지 점검
> # 종료. Esc 두 번

[loop · 5m] queue 확인 ...
대기 중. 다음 5m 후
[loop · 5m] queue 끝남 → 후처리 시작
완료. loop 자동 종료

시나리오

계속 지켜봐야 하는 작업.

• 시뮬레이션 자리. LAMMPS 큐 종료 감시 — 끝나면 후처리 자동 시작.
• 박사후 · 신진. 새 논문 알림 메일 폴링 — 오면 요약하고 노트에 남김.
• 모두. CI 감시 — 빌드 끝나면 결과 요약.

함정

/loop, 알아둘 한도와 팁.

개념

사용법

등록 · 조회 · 수정 · 삭제.

> /schedule daily PR review 9am
> /schedule list
> /schedule update rtn_xxx [자연어]
> /schedule delete rtn_xxx

등록됨. rtn_8c2b...
실행. 매주 금 17:00 KST
다음 — 2026-05-08(금) 17:00

시나리오 · 함정

자연어 한 줄로 정기 작업.

• 행정 · 정책. 매일 8시 부처 보도자료 요약 → 위키.
• 코드 · 논문. 매주 금 17시 commit 요약 → README.
• 최소 1시간. 더 잦은 폴링은 /loop로.
• Routines 통합. 같은 routine — /schedule list에 모두 표시.

개념

/effort — 생각의 깊이를 조절.

사용법

강도를 바꾸는 세 가지 방법.

> /effort               # UI
> /effort xhigh
PS> claude --effort high
# 스킬 프론트매터
---
effort: high
---

[low]   표본 30이 적다는 비판은 ... (3줄)
[xhigh] 표본 30의 근거는 효과 크기
        d=0.8 추정에 ...
        통계검정력 0.8 보장 ...
        검정력 분석 표 ...

작업 매트릭스

어떤 작업에 어떤 강도?

함정 · 팁

Auto에 맡기거나, 스킬마다 고정.

개념

매일 쓰면 편한 UX 보조 5종.

사용법

UX 보조, 한 줄씩.

> /powerup           # 가이드
> /focus             # 본문만
> /copy              # 클립보드
> /terminal-setup
> /less-permission-prompts

최근 30일 트랜스크립트 분석
자주 묻힘.
  Bash(git status)
  Read(./data/**)
  Bash(Get-ChildItem)
allow에 추가할까요? (Y/n)
완료. settings.json 업데이트

팁

처음 쓰는 동료에게 권하는 순서.

• /powerup 한 마디. Claude Code를 처음 쓰는 동료에게 — 5분 가이드.
• /copy. 회의록 자주 다루는 분 — 응답을 한 번에 복사 → 워드에 붙여넣기.
• /focus. 강사 시연 · 영상 녹화 때 화면이 깔끔해져요.
• /less-permission-prompts. 한 주 써 본 뒤 한 번 — 매번 묻는 게 절반으로.

Advanced 트랙 마무리

총 22개 — 여기까지 봤습니다.

5문장 회수 · 본인 점검

다섯 개 중 네 개 이상이면 OK.

1. LO-1. 나는 PowerShell에서 claude를 열고 첫 응답을 받을 수 있다.
2. LO-2. 나는 내 폴더에 CLAUDE.md를 두고 효과 차이를 안다.
3. LO-3. 나는 Plan 모드와 deny 한 줄로 안전망을 갖췄다.
4. LO-4. 나는 내 시나리오 한 개를 Claude Code로 끝까지 수행할 수 있다.
5. LO-5. 나는 환각 · 재현성 · 보안 우려에 한 문장씩 답할 수 있다.

마지막 한 컷

자주 받는 세 가지 우려.